home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin / lfschkpt.man < prev    next >
Encoding:
Text File  |  1991-06-01  |  3.6 KB  |  84 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/admin/lfschkpt/RCS/lfschkpt.man,v 1.1 91/05/31 13:01:33 mendel Exp Locker: mendel $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS LFSCHKPT cmds
  13. .BS
  14. .SH NAME
  15. lfschkpt \- Display or modify the checkpoint fields of an LFS file system.
  16. .SH SYNOPSIS
  17. .nf
  18. \fBlfschkpt [\fIoptions\fR] \fIdeviceName\fR
  19. .SH OPTIONS
  20. .IP \fIdeviceName\fP 14
  21. The device on which the file system should be created. The partition 
  22. should contain an unmounted LFS file system. WARNING: This program
  23. should not be run on a running (attached) file system.
  24. .IP "\fB\-maxNumCacheBlocks\fI NumCacheBlocks\fR" 14
  25. \fINumCacheBlocks\fP is the maximum number of file cache blocks to used during
  26. cleaning.
  27. .IP "\fB\-checkpointInterval\fI CheckpointInterval\fR" 14
  28. \fICheckpointInterval\fP is the frequency in seconds to perform 
  29. checkpoints.
  30. .IP "\fB\-domainNumber\fI DomainNumber\fR" 14
  31. \fIDomainNumber\fP is the Sprite domain number assigned to this file system.
  32. A value of -1 will caused to system to assign it a number upon the
  33. next attach.
  34. .IP "\fB\-serverID\fI id\fR" 14
  35. \fIid\fP is the Sprite hostname id specified in the superblock.  This
  36. id is used to inform a machine of its name at boot time.  
  37. .IP "\fB\-maxUtilization\fI Utilization\fR" 14
  38. \fIUtilization\fP is the maximum fraction of the disk space usable by
  39. the file system.  
  40. .IP "\fB\-maxDesc\fI NumDesc\fR" 14
  41. \fINumDesc\fP is the maximum number of descriptors available in the
  42. file system. A negative value causes mklfs to compute this number
  43. based on the disk size.
  44. .IP "\fB\-segAlignment\fI Alignment\fR" 14
  45. \fIAlignment\fP is the alignment in bytes where the first segment should start.
  46. .IP "\fB\-minNumClean\fI numSegments\fR" 14
  47. \fInumSegments\fP is minimum number of clean segments to maintain in the
  48. file system. This number acts as an lower bound as when to start segment
  49. cleaning.
  50. .IP "\fB\-minFreeBlocks\fI numBlocks\fR" 14
  51. \fInumBlocks\fP is minimum number of free blocks before the system will
  52. stop allowing block allocate requests.  This number decides the
  53. maximum disk space utilization.
  54. .IP "\fB\-wasteBlocks\fI numBlocks\fR" 14
  55. \fInumBlocks\fP is the number of blocks the system will waste while filling
  56. in a segment.
  57. .IP "\fB\-numSegsToClean\fI numSegments\fR" 14
  58. \fInumSegments\fP is number of segments the segment cleaner will generate
  59. This number acts as the threshold under which cleaning is stopped.
  60. .IP "\fB\-both\fR" 14
  61. Display both checkpoint regions.
  62. .IP "\fB\-write\fR" 14
  63. Apply requested changes to the disk.
  64. .BE
  65.  
  66. .SH DESCRIPTION
  67. .PP
  68. \fBLfschkpt\fR displays the LFS superblock and checkpoint region
  69. headers and allows for the user to specify changes to these
  70. data structures.  
  71. With no arguments specified, \Blfschkpt\fR displays the data structures.
  72. The \fB\-write\fR option allows changes to be made to the disk and
  73. should only be run when the file system is not attached.  The rest
  74. of the options specify field names in the LfsSuperBlock and LfsCheckPointHdr
  75. data structures that may be changed.   A field value of -2 (the default)
  76. means no change. 
  77. .SH WARNING
  78. .PP
  79. \fBLfschkpt\fR does no error checks on changes being made. It is possible
  80. to render the file system unattachable with this command.
  81. .SH KEYWORDS
  82. filesystem, LFS, sprite
  83.  
  84.